All the a11y themes in this module inherit from the 'gnome' theme.
The 'gnome' theme is in the gnome-icon-theme module, and has to be built and installed separately.
1. Editing the gtkrc files
--------------------------
The gtkrc.in files for each a11y theme are currently generated by autogen.sh. Each gtkrc.in file is the concatenation of these files:
$theme/gtk-2.0/$theme.rc
common/gtk-stock-icons.rc
common/panel-stock-icons.rc
common/media-stock-icons.rc
common/capplet-stock-icons.rc
It follows that you should NOT edit gtkrc.in directly. Instead, edit the appropriate .rc file, then re-autogen before building. This obviously kind of sucks, but it was the only way I could get it to work at the time :/
2. Adding new icons
-------------------
The module is currently configured to make it easy to add or remove a stock icon from all themes at once, but not so easy to do so on a per-theme basis. This works well for now but probably won't if we want to make this a more general theme repository.
So, to add a new gtk stock icon to all themes:
- Add the icon's filename to common/all-stock-items.data
- Add the line you want to appear in the themes' RC files to the appropriate common/*.rc file
- Add the icon files, each with the same filename, to all the <theme>/pixmaps/ directories.
GNOME icons that are themed via the icon theming mechanism (as specified on freedesktop.org) are currently still added individually in each <theme>/icons subdirectory. E.g. to add a new 48x48 application icon to all the themes, you have to modify each <theme>/icons/48x48/apps/Makefile.am individually, and add the appropriate icon file to each <theme>/icons/48x48/apps directory.
3. Changing icon sizes
----------------------
The icon sizes for ALL the LargePrint themes are defined in configure.in. Changing them here will affect all LargePrint themes.
4. Changing colours
--------------------
To change the colours in a particular theme, edit its <themename>/gtk-2.0/<themename>.rc file.
5. Switching icon themes
------------------------
In 2.2 and later, use gnome-theme-manager, and choose the Icon theme from the Details subdialog.
In earlier versions of GNOME, unless you're running my patched theme switcher dialog (patch in bugzilla,
#93486), you'll need to switch icon themes by hand using GConf: